home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / db_other / 12150g01.ziv / WAMPUM45.EXE / lha / WAMPUM / README.DOC < prev    next >
Text File  |  1993-02-25  |  73KB  |  1,150 lines

  1.                       WAMPUM 4.5 Supplemental Documentation
  2.  
  3.      This documentation supplements the existing Second Edition, User's Guide
  4. and provides a thorough discussion of ALL new WAMPUM 4.5 features.  This format
  5. was chosen because of the substantial existing user base for earlier versions. 
  6. In short, you do not have to print or read the existing Second Edition User's
  7. Guide if you already have mastered it.  If you are new to WAMPUM, please read
  8. the User's Guide FIRST.  Only features of WAMPUM 4.0 forward are outlined here.
  9.  
  10.      WAMPUM continues to be one of the fastest and most powerful dBASE-
  11. compatible products on the market.  Individual files are "limited" to one
  12. billion records (if you can afford the disk storage).  400 fields per data base
  13. are supported, and memo fields are limited only by the amount of available
  14. system memory in your system. This version is compatible with WAMPUM Remote,
  15. an ANSI/BBS Door version of WAMPUM supporting multi-user remote dial-in access.
  16.  
  17.      WAMPUM 4.5 finally brings FULL relational power to the ShareWare market. 
  18. The breadth of new features also provides the best of every known data base on
  19. the market as well as a few specials of our own.  These include:
  20.  
  21.      *    WAMPUM now can be loaded as a pop-up TSR consuming less than 20K
  22.  
  23.      *    Version 4.5 directly supports .PCX image fields while retaining dBASE
  24.           file compatibility.  Hercules, EGA, and VGA monitors are supported.
  25.  
  26.      *    Fully relational table lookup from up to 9 "pop-up" data bases
  27.  
  28.      *    Reports and mailing labels using up to 5 relational data bases
  29.  
  30.      *    State-of-the-art form letters using up to 5 relational data bases
  31.  
  32.      *    Unlimited computational functions in RELATED data bases means you can
  33.           develop full-featured accounting or inventory systems without writing
  34.           a single line of program code!
  35.  
  36.      *    "Power Browse" brings the BEST full screen browse utility to the
  37.           market allowing complete edit, update, append, delete, and undelete
  38.           functionality on a single screen containing any selected group of
  39.           records from a data base of any size.  These records are displayed in
  40.           spreadsheet format (15 records per screen).  Hot keys allow you to
  41.           move to the top or bottom of a file as well as any particular record.
  42.  
  43.      *    New UNIQUE table permits automatic generation of order numbers, part
  44.           numbers, or any other field requiring a unique key.
  45.  
  46.      *    New PHONFILE table brings a "pop-up" phone dialer to WAMPUM.
  47.  
  48.      *    New DOSAPPS table brings a "pop-up" DOS application menu to WAMPUM
  49.           permitting users to select and run DOS applications requiring up to
  50.           512K of memory WITHOUT EVER LEAVING WAMPUM.  Move over DesqView!
  51.  
  52.      *    New DITTO hot-key allows users with a single keystroke to instantly
  53.           duplicate any previously typed field data.
  54.  
  55. System Requirements:  512K PC/XT/AT/286/386/486 with DOS 2.1 or higher. DOS 3.1
  56. or higher is required for network applications.  Hard disk is strongly recom-
  57. mended although WAMPUM will run on a dual floppy system with at least one 720K
  58. or higher floppy drive.  WAMPUM requires 390K of free and clear RAM to load! 
  59. To display .PCX picture fields in your data bases, you must have either a VGA,
  60. EGA, CGA or Hercules-compatible graphics card and monitor.
  61. Licensing:  30-day ShareWare license, no charge.  Single-user license, $50 per
  62. PC plus $5 shipping/handling ($10 foreign) for user's choice of latest available
  63. versions.  Network license, $195 per network server plus $5 shipping/handling
  64. for unlimited use on a single network.  Soft-bound Second Edition manual, $20.
  65.  
  66. Support:  90 days free telephone support by calling 404/237-9420 between the
  67. hours of 6 p.m. and 9 p.m. Atlanta time, Monday through Thursday.  90 days free
  68. BBS or mail support to registered users in addition to telephone support. Call
  69. our BBS at 706/746-5109.  Save $$'s on voice calls: 10288-0-700-WARD-MUNDY.
  70.  
  71. Product Reviews:  Many ask whether WAMPUM has been evaluated and, if so, what
  72. the reviewers said about the product.  Here is a sample of reviews covering
  73. version 3 of WAMPUM:
  74.  
  75.           "WAMPUM is the best database manager I know of.  [It's] a
  76.           dBASE III clone that, in reality, is a great improvement over
  77.           the original.  It is not only a database manager with an
  78.           excellent, easy-to-learn interface, it is a complete
  79.           development package.  It features a long, impressive list of
  80.           capabilities and is fully file-compatible with dBASE III. The
  81.           documentation . . . is excellent explaining all the WAMPUM
  82.           functions in detail."  Jim Pile, PCM Magazine.
  83.  
  84.           "WAMPUM is comparable to dBASE III in features and power but
  85.           offers a menu-driven interface.  It uses a dBASE III -
  86.           compatible file structure and offers network support,
  87.           multiple indexes, relational functions, printer templates,
  88.           macros, and password protection."  George Campbell, PC World.
  89.  
  90.           "WAMPUM is well-conceived and well-implemented... impressive,
  91.           a must for anyone who seeks simplified dBASE capabilities. 
  92.           WAMPUM might be viewed as what Ashton-Tate's RapidFile should
  93.           have been, a menu-driven version of dBASE.  WAMPUM  is more
  94.           powerful and much cheaper than RapidFile and Alpha Three,
  95.           other attempts to put a menu face on dBASE.  With network
  96.           support and other clever features, WAMPUM is, in many ways,
  97.           more capable than dBXL." John L. Hawkins, Data Based Advisor.
  98.  
  99.           "The question may not be 'how much does it cost.' The only
  100.           valid question is 'Will it do the job for me?' . . . For
  101.           personal or recreational database use, WAMPUM is a gift-horse
  102.           that you can afford to 'look in the mouth.'  For business,
  103.           here is an industrial grade product full of embellishments. 
  104.           Indeed, WAMPUM is close to dBASE III Plus in performance." 
  105.           Hal Nieburg, Computer Shopper.
  106.  
  107.  
  108. And now, WAMPUM 4.5 brings you FULL RELATIONAL POWER plus ease of use and up to
  109. 50 per cent better performance than dBASE III Plus:
  110.  
  111.                  Using 10,000 records   WAMPUM    dBASE III Plus  
  112.                  ---------------------  -------   --------------                   
  113.                                          
  114.                  Index all records      17 sec.        27 sec.    
  115.                  Count random records    5 sec.         7 sec.    
  116.                  List random records     8 sec.        12 sec.    
  117.                  Replace all records    23 sec.        34 sec.    
  118.  
  119.  
  120.      WAMPUM has been developed and refined over a period of seven years.  Hype
  121. aside, we think you will find it offers more features and performance per dollar
  122. than ANY other data base package in the world.  It was written the old-fashioned
  123. way, in a basement.  It was not developed by committee or by hired hands. And we
  124. have never spent one nickel advertising WAMPUM.  Consequently, it is also the
  125. least expensive data base package in the world.  We plan to keep it that way. 
  126. It might also interest you to know that the last "bug" report filed by a user
  127. was over 18 months ago.  If any of these diffferences from commercial products
  128. trouble you, then please feel free to look elsewhere for your DBMS product.  
  129.  
  130.      Our special thanks goes to the thousands of current WAMPUM users.  Most of
  131. the new features in version 4 are the result of their suggestions.  If you have
  132. ideas that would make WAMPUM a more useful product, please drop us a note. 
  133. We'd love to hear from you, too!
  134.  
  135.      The User's Guide fully explains the concept of ShareWare if you don't
  136. already know.  It is a "try before you buy" deal.  It does not mean use the
  137. software forever without compensating the author.  Unlike some ShareWare authors
  138. who receive substantial revenues from commercial sales of their products, we
  139. don't do this for one simple reason: it costs you money!
  140.  
  141.    This program is produced by a member of the Association of Shareware
  142. Professionals (ASP).  ASP wants to make sure that the shareware principle
  143. works for you. If you are unable to resolve a shareware-related problem with
  144. an ASP member by contacting the member directly, ASP may be able to help. The
  145. ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
  146. but does not provide technical support for members' products. Please write to
  147. the ASP Ombudsman at 545 Grover Rd, Muskegon, MI 49442-9427 or send CompuServe
  148. message via CompuServe Mail to ASP Ombudsman 70007,3536.
  149.  
  150.      While any dummy can create a data base, add a few records, and print a list
  151. or report, there is much, much more to WAMPUM.  It was designed to meet all the
  152. data base requirements of very sophisticated businesses and organizations.  What
  153. you get out of WAMPUM is directly proportional to the effort you are willing to
  154. put into learning it.
  155.  
  156.      Beginning with this version of WAMPUM, we will provide two years' worth of
  157. free WAMPUM updates to anyone who sends us an uncopyrighted, WAMPUM application
  158. which we deem sophisticated enough to place on our bulletin board system.  A few
  159. pages of documentation on disk also would be appreciated as well as a brief
  160. summary of the function of the application.  Please indicate which version of
  161. WAMPUM is required for the application, e.g. Clipper, dB3, or FoxBASE+.
  162.  
  163.      WAMPUM's power is derived from our use of the very best compilers in the
  164. personal computer data base market.  As you may have read, the so-called dBASE
  165. market is splintering badly as we enter the 1990's.  For this reason, future
  166. versions of WAMPUM may have significant differences depending upon the version
  167. you order.  The next page summarizes our current offerings.
  168.  
  169.  
  170. The following software licenses currently are available from Ward Mundy
  171. Software, 4160 Club Drive, Atlanta, GA 30319 USA:
  172.  
  173. WAMPUM 4.5C (Clipper-compatible indexes)  is a full-featured, fully-relational,
  174. menu-driven, memory resident dBASE III Plus-compatible data base management
  175. system.  As with all current WAMPUM versions, WAMPUM 4.5C uses dBASE III-
  176. compatible data bases except users may opt to increase the number of data base
  177. fields beyond 128 and up to 400.  If the number of fields exceeds 128, then
  178. dBASE III file compatibility is forfeited.  This would mean that such data bases
  179. could no longer be used with products such as dBASE III Plus, dBASE IV,
  180. FoxBASE+, or FoxPro.  If performance is a key consideration and/or reliability
  181. on a network, we would recommend version 4.5C to you.
  182.  
  183. WAMPUM 4.5D (dBASE III+ compatible indexes) is virtually identical to WAMPUM
  184. 4.5C except that this version uses dBASE III Plus-compatible indexes.  Indexes
  185. are the supplemental files that WAMPUM uses to maintain sorts of your data base. 
  186. While the indexes are functionally equivalent to Clipper indexes, their internal
  187. format is different.  With large data bases, Clipper indexes tend to be much
  188. smaller and much faster in operation.  dBASE III Plus indexes are comparatively
  189. poor performers in a network environment.  However, if you use dLITE, dBASE III
  190. Plus or dBASE IV and need to maintain index as well as data base compatibility,
  191. we would recommend version 4.5D to you.
  192.  
  193. WAMPUM 3.3F (FoxBASE+ version) provides the functionality described in the
  194. Second Edition of the User's Guide.  Currently, it does NOT support version 4
  195. enhancements described in this README file.  Its other key difference from the
  196. above versions is that it relies upon the FoxBASE+ run-time interpreter which is
  197. licensed to you with the WAMPUM software.  Because FoxBASE+ is an interpretive
  198. language, it gives WAMPUM the added flexibility of providing you a simulated dot
  199. prompt or "command mode."  In this mode, you can enter dBASE-like commands just
  200. as you would with dBASE III Plus.  You also can write your own simple, unnested
  201. programs up to approximately 500 lines of code.  We do NOT provide technical
  202. support on matters regarding the command mode or programs you write.  Virtually
  203. any good dBASE III Plus reference book can assist you with the available
  204. commands in the dBASE language.  FoxBASE+ is a superset of that language.
  205.  
  206. WAMPUM 3.3C or 3.3D (Floppy-only versions) are available to those with no hard
  207. disk and no floppy disk support above 360K format.  2d Edition functions apply.
  208.  
  209. dLITE 1.1 (dBASE III+ compatible indexes) is a pop-up, memory resident desktop
  210. file manager.  It permits a user to access up to 10 different dBASE-compatible
  211. data base applications from within almost any text-based application.  In
  212. addition to powerful file management functions, dLITE also includes a unique
  213. paste function permitting users to extract data from any data base and stuff it
  214. into a word processing document, spreadsheet, or any other foreground appli-
  215. cation.  System requirements: 160K free RAM or 100K with 64K expanded memory.
  216.  
  217. Badge-O-Magic 2.0 (Clipper or dBASE III compatible indexes) is a program which
  218. produces one to four line badges or name tags using any LaserJet II-compatible
  219. laser printer.  Six soft fonts are included with the software providing type
  220. sizes of 12 to 40 points with automatic font sizing and centering on the badges. 
  221. This is the ideal product for those needing easy-to-read name tags for conven-
  222. tions, meetings, or social gatherings.  The software is completely menu-driven
  223. and includes a powerful file manager for manipulating dBASE III-compatible data.
  224.  
  225. MenuMaker is a software development tool which allows a developer to draw a data
  226. entry screen as it should appear with any of the WAMPUM or dLITE products. 
  227. Using point-and-shoot menus, the developer then links the data entry screen to
  228. the desired data base.  MenuMaker then writes the necessary application code.
  229. I.  Developer's Power Browse
  230.  
  231.     WAMPUM 4.5 sets a new standard for full-screen BROWSE functionality in DBMS
  232. software currently on the market.  Instead of displaying one record for editing
  233. at a time, POWER BROWSE displays 15 records simulataneously.  Records quickly
  234. can be ADDED, CHANGED, DELETED, or UNDELETED within the POWER BROWSE facility.
  235.  
  236.     POWER BROWSE also allows you to predefine the sort order and group of
  237. records with which you want to work.  For example, you could select just records
  238. entered for a given month to browse.  Or, you could choose just those records in
  239. which a payment was overdue.
  240.  
  241.     To run POWER BROWSE, follow these simple steps:
  242.  
  243.     (1)  Start WAMPUM in developer mode by typing WAMPUM VOODOO at DOS prompt.
  244.  
  245.     (2)  Choose the file and indexes with which you wish to work.  Press ALT-I
  246.          from the Main System Menu to select the lead index for sorting data.
  247.  
  248.     (3)  Press ALT-S from the Main Menu if you wish to narrow down the group of
  249.          records to be used in POWER BROWSE.  Or, you may enter standard dBASE
  250.          selection criteria by choosing the S - Select Utilities option.
  251.  
  252.     (4)  If you want to work with a specific group of fields in the data base or
  253.          if you want to reorder the sequence of the field display, press ALT-B
  254.          and type Y when asked whether to select browse fields.  Highlight the
  255.          first field to be displayed and press <ENTER>.  Continue this process
  256.          for any additional fields you want to work with.  When finished, <ESC>.
  257.  
  258.     (5)  Choose S - Select Utilities option.  Use the <Down> cursor to move to
  259.          the Developer's Browse Mode option.  Type Y in this field and <PgDn>.
  260.  
  261.     (6)  The POWER BROWSE screen will appear.  A sample is shown below.  The top
  262.          box of the display tells you what special functions are available.
  263.  
  264.                |-------------------------------------------------|
  265.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit.|
  266.                |     ^Home - 1st Field   ^End - Last Field       |
  267.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |
  268.                |-------------------------------------------------|
  269.                                                                  
  270. |---<Record 1 of 2>------------------------------------------------------------|
  271. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  272. |------------------------------------------------------------------------------|
  273. | Adams           | 10/10/89 |        14.00 |     1.00 |    T    |   <Memo>    |
  274. | Smith           | 11/12/89 |        10.00 |     9.00 |    F    |   <Memo>    |
  275. |                 |          |              |          |         |             |
  276. |                 |          |              |          |         |             |
  277. |                 |          |              |          |         |             |
  278. |                 |          |              |          |         |             |
  279. |                 |          |              |          |         |             |
  280. |                 |          |              |          |         |             |
  281. |                 |          |              |          |         |             |
  282. |                 |          |              |          |         |             |
  283. |                 |          |              |          |         |             |
  284. |                 |          |              |          |         |             |
  285. |                 |          |              |          |         |             |
  286. |                 |          |              |          |         |             |
  287. |---<ALT-R to Reposition>------------------------------------------------------|
  288.     (7)  If you wish to reposition to a particular record in the file, you may
  289.          press the ALT-R key which will display a light-bar menu in the middle
  290.          of the browse window as shown below.  To move to the Bottom of File,
  291.          simply highlight this option and press <ENTER>.  To move to a parti-
  292.          cular record number, highlight the Pick Record # option, press <ENTER>,
  293.          type in the desired record number, and press <ENTER>.  If your file is
  294.          indexed, you can move to the closest matching key to any value you
  295.          enter by highlighting the Matching Key option, pressing <ENTER>,
  296.          typing all or part of the key to find, and pressing <ENTER> again. 
  297.          Please note that if your lead index is a date field, the date to find
  298.          must be entered in the format YEAR, MONTH, DAY.  For example, if the
  299.          FILINGDT field entry for 11/12/89 was desired, you would enter
  300.          19891112 and press <ENTER>.                             
  301.                                                                  
  302.                                                                  
  303.                |-------------------------------------------------|
  304.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit |
  305.                |     ^Home - 1st Field   ^End - Last Field       |
  306.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |
  307.                |-------------------------------------------------|
  308.                 
  309. |---<Record 1 of 2>------------------------------------------------------------|
  310. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  311. |------------------------------------------------------------------------------|
  312. | Adams           | 10/10/89 | |================| 1.00 |    T    |   <Memo>    |
  313. | Smith           | 11/12/89 | |Top of File     | 9.00 |    F    |   <Memo>    |
  314. |                 |          | |Bottom of File  |      |         |             |
  315. |                 |          | |Pick Record #   |      |         |             |
  316. |                 |          | |Matching Key    |      |         |             |
  317. |                 |          | |Abort Search    |      |         |             |
  318. |                 |          | |                |      |         |             |
  319. |                 |          | |                |      |         |             |
  320. |                 |          | |                |      |         |             |
  321. |                 |          | |                |      |         |             |
  322. |                 |          | |                |      |         |             |
  323. |                 |          | |================|      |         |             |
  324. |                 |          |              |          |         |             |
  325. |---<ALT-R to Reposition>------------------------------------------------------|
  326.                                 
  327.                                 
  328.     (8)  There are two ways to change existing data.  You may simply type over
  329.          the data that is already there.  If you start typing, the rest of the
  330.          current field will be erased automatically.  Or, you may move to the
  331.          desired field, press <ENTER>, and then begin typing the new data.  In
  332.          the latter case, existing data will NOT be erased when you start
  333.          typing.  Press CTRL-Y to delete from cursor to end of field.  When the
  334.          data has been entered as desired, press <ENTER> to SAVE your changes.
  335.                                 
  336.     (9)  If you begin changing a field and discover you have made a mistake,
  337.          simply press <ESC> to restore the original entry.
  338.                                 
  339.     (10) To mark a record deleted, move the cursor to the desired record, and
  340.          press either the <DEL> key or <CTRL-U>.  To unDelete a record marked
  341.          for deletion, repeat this process again.  In short, <DEL> and CTRL-U
  342.          toggle the delete function ON and OFF.
  343.                                 
  344.     (11) To edit MEMO fields, highlight the desired field in the desired record. 
  345.          The middle of the BROWSE SCREEN will tell you whether the MEMO field 
  346.  
  347. contains data.  Press <ENTER> to edit the field. To SAVE your changes, press
  348. CTRL-W.  To exit without saving your changes, press <ESC>.
  349.                                 
  350.     (12) Shown below is a sample memo field once the MEMO EDITOR is called by
  351.          pressing <ENTER> while positioned over a MEMO field.
  352.                                 
  353.                |-------------------------------------------------|
  354.                |Use Arrows to move, ^W to save&end, <ESC> to quit|
  355.                |   ^Home - Top of Memo   ^End - End of Memo      |
  356.                |    PgUp - Up 1 Screen   PgDn - Down 1 Screen    |
  357.                |-------------------------------------------------|
  358.                                                                  
  359. |---<Record 1 of 2>--------------<Memo Data>-----------------------------------|
  360. |    EDITING KEYS: ^W=SAVE  Esc=ABORT  ^N=LINE INS  ^T=WORD DEL  ^Y=LINE DEL   |
  361. |------------------------------------------------------------------------------|
  362. | |--------------------------------------------------------------------------| |
  363. | |Here is a sample comment for record 1.                                    | |
  364. | |                                                                          | |
  365. | |                                                                          | |
  366. | |                                                                          | |
  367. | |                                                                          | |
  368. | | MEMO FIELD: COMMENTS--------------------------------------------RAM: 60K | |
  369. |---<ALT-R to Reposition>------------------------------------------------------|
  370.                                                                               
  371.                                                                               
  372.     (13) If you wish to ADD new records to your existing data base while in   
  373.          POWER BROWSE mode, move to the bottom of the file using either the   
  374.          cursor keys, CTRL-PgDn, or the ALT-R function.  Then press the <Down>
  375.          cursor key.  A beep will tell you that you are adding a new record to
  376.          the data base.  To abort the process, press the <Up> arrow.  Otherwise,
  377.          type the desired data and press <ENTER> to save each new field entry. 
  378.          NOTE:  You cannot add data to a MEMO field while in ADD mode without 
  379.          first adding data to some other non-MEMO field in the new record.    
  380.                                                                               
  381.                                                                               
  382.                |-------------------------------------------------|            
  383.                | Use Arrows to MOVE, <CR> to EDIT, <ESC> to quit.|            
  384.                |     ^Home - 1st Field   ^End - Last Field       |            
  385.                |    ^PgUp - 1st Record   ^PgDn - Last Record     |            
  386.                |-------------------------------------------------|            
  387.                                                                                
  388. |---<Adding Record 3>----------------------------------------------------------|
  389. | LASTNAME          FILINGDT   FILINGFEE      OTHERFEE   MARRIED   COMMENTS    |
  390. |------------------------------------------------------------------------------|
  391. | Adams           | 10/10/89 |        14.00 |     1.00 |    T    |   <Memo>    |
  392. | Smith           | 11/12/89 |        10.00 |     9.00 |    F    |   <Memo>    |
  393. | *************** |   /  /   |         0.00 |     0.00 |    F    |   <Memo>    |
  394. |-------------------------------<Add Record>-----------------------------------|
  395.                                                                                
  396.                                                                                
  397.     (14) SPECIAL NOTE:  The usual WAMPUM Edit Checks are not executed when you 
  398.          add or change data using the POWER BROWSE option.  This is the reason 
  399.          the function is reserved for those with the DEVELOPER PASSWORD only!  
  400.                                                                                
  401.     (15) When you finish using POWER BROWSE, simply press <ESC> to exit.       
  402.          Confirm your desire to exit by typing Y.  The Main Menu will reappear.
  403.                                                                          
  404.  
  405. II.  "Pop-Up" Relational Tables for Table Lookup                         
  406.                                                                          
  407.     Now you can design up to 9 "pop-up" tables to assist end-users with data
  408. entry.  They can choose any desired entry in the table and simply press the
  409. <ENTER> key to stuff one or more entries in the lookup table into the foreground
  410. data entry screen.  The developer can either define which fields get stuffed
  411. when the end-user selects an entry, or the developer can leave it up to the end-
  412. user to determine which field to stuff.                                  
  413.                                                                          
  414.     An example may help.  Suppose one is entering orders into a customer order
  415. data base for a parts supplier.  Rather than having to type the customer's name,
  416. address, city, state, and zip code each time the customer orders a product, we
  417. would like to look up this information in a "pop-up" customer file and "stuff"
  418. the necessary data into our orders file.  We also would like to do the same
  419. thing with the various parts that a customer wishes to order.  In other words,
  420. we want to look up the part number, the part name, and the cost of the part.
  421.                                                                          
  422.     WAMPUM now lets you design 9 such tables and "store" them under 9 "hot-keys"
  423. so that a user can press ALT-1 through ALT-9 and "pop-up" the desired table at
  424. any time while adding or editing records using the A - ADD or E - EDIT options.
  425.                                                                          
  426.     To create table lookup applications, you must do three things.  First,
  427. create the TABLE.DBF file structure shown below using the B - BUILD NEW FILE
  428. option, or you may simply copy the TABLE.DBF file provided on the distribution
  429. diskette into each application directory you create.  Second, create the table
  430. file (such as the CUSTOMER file or PARTS file described above) and any desired
  431. index to order entries within the file.  Third, create an entry in the TABLE
  432. data base file to describe which hot key the user should press and what should
  433. happen when the key is pressed.                                          
  434.                                                                          
  435.                                                                          
  436.                        Step 1 - Building A New TABLE.DBF File            
  437.                                                                          
  438.     Start WAMPUM in Developer Mode by typing WAMPUM VOODOO.  Choose B - Build
  439. New File.  When prompted for a file name, type TABLE and press <ENTER>.  Type in
  440. the following entries:
  441.  
  442.           NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  443.           ---  ----------    ----     ---------    -------
  444.            
  445.             1  FILE           C           20          0
  446.             2  INDEX          C           20          0
  447.             3  PROMPT         C           40          0
  448.             4  DISPLAY1       C           10          0
  449.             5  DISPLAY2       C           10          0
  450.             6  DISPLAY3       C           10          0
  451.             7  DISPLAY4       C           10          0
  452.             8  DISPLAY5       C           10          0
  453.             9  DISPLAY6       C           10          0
  454.            10  DISPLAY7       C           10          0
  455.            11  DISPLAY8       C           10          0
  456.            12  DISPLAY9       C           10          0
  457.            13  FLDDATA1       N            3          0
  458.            14  FLDFILE1       C           10          0
  459.            15  FLDDATA2       N            3          0
  460.            16  FLDFILE2       C           10          0
  461.            17  FLDDATA3       N            3          0
  462.            18  FLDFILE3       C           10          0
  463.            19  FLDDATA4       N            3          0
  464.           NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  465.           ---  ----------    ----     ---------    -------
  466.            
  467.            20  FLDFILE4       C           10          0
  468.            21  FLDDATA5       N            3          0
  469.            22  FLDFILE5       C           10          0
  470.            23  FLDDATA6       N            3          0
  471.            24  FLDFILE6       C           10          0
  472.            25  FLDDATA7       N            3          0
  473.            26  FLDFILE7       C           10          0
  474.            27  FLDDATA8       N            3          0
  475.            28  FLDFILE8       C           10          0
  476.            29  FLDDATA9       N            3          0
  477.            30  FLDFILE9       C           10          0
  478.            
  479.     When all entries have been typed, press <ESC>.  When asked whether to
  480. proceed with building the file, type Y.
  481.            
  482.     In the alternative, you may copy the TABLE.DBF file which was provided with
  483. your copy of WAMPUM.  You will need to copy it to EVERY directory in which you
  484. build a WAMPUM application unless you wish to leave it in the DOS PATH and
  485. access it from multiple WAMPUM applications.  The philosophy of designing WAMPUM
  486. applications and where to place system files is covered in the Developer's
  487. Section of the User's Guide.
  488.            
  489.                  Step Two - Creating the Relational Data Base
  490.            
  491.     This step obviously is application specific.  What information do your users
  492. need to look up without having to refer to printed lists, cheat sheets, and the
  493. like?  A sample application is stored in a directory on your disk named
  494. \WAMPUM\SAMPLE1.  Move to this directory by typing CD \WAMPUM\SAMPLE1 at the DOS
  495. PROMPT.  Print the README.DOC file in this directory by typing:
  496.            
  497.                          COPY README.DOC PRN
  498.            
  499.     Read the documenation then type WAMPUM VOODOO to start up WAMPUM.  This
  500. sample application contains two table lookup data bases: one for customers and
  501. one for parts.  Notice that each is indexed on a key field. This enables quick
  502. retrieval of data in sorted order for display in the pop-up table.
  503.            
  504.     Add a record to the data base.  When the blank form appears, press ALT-9
  505. then <ENTER> to display the customer file.  Mundy will be highlighted.  Press
  506. <ENTER> to "stuff" Mundy's customer information into your order form.  Now press
  507. ALT-1 then <ENTER>, highlight a part, and press <ENTER> again.  This will
  508. "stuff" part information into the order form.  That's all there is to it!
  509.            
  510.            
  511.               Step Three - Building the Table Entry in TABLE.DBF
  512.            
  513.     What makes all this magic work depends upon what you enter into the TABLE
  514. data base.  This data base determines which "hot-keys" are enabled and what
  515. happens when an end-user presses one of them.
  516.            
  517.     The record numbers of entries in the TABLE.DBF file correspond to the "hot-
  518. keys" they will activate.  In short, if entries are made in record 1, then these
  519. entries will be executed when the user presses the ALT-1 "hot-key."  If entries
  520. are made in record 2, these are executed by pressing ALT-2.  And so on.  Up to 9
  521. records can be added to the TABLE.DBF file corresponding to ALT-1 thru ALT-9. 
  522. Any blank records in TABLE.DBF are ignored and will not activate a hot-key.
  523.     Let's examine a typical TABLE.DBF entry:
  524. |--------------------------------------------------------------------------|
  525. |Record No.      1                                                         |
  526. |                                                                          |
  527. |FILE| PART                 INDEX| PART                                    |
  528. |                                                                          |
  529. |PROMPT| Enter part name or <ENTER> for all:      DISPLAY1|PART            |
  530. |                                                                          |
  531. |DISPLAY2|PARTNO      DISPLAY3|ONHAND      DISPLAY4|COST                   |
  532. |                                                                          |
  533. |DISPLAY5|PRICE       DISPLAY6             DISPLAY7                        |
  534. |                                                                          |
  535. |DISPLAY8             DISPLAY9             FLDDATA1   7  FLDFILE1|PARTNO   |
  536. |                                                                          |
  537. |FLDDATA2|  8  FLDFILE2|PART        FLDDATA3|  9  FLDFILE3|PRICE           |
  538. |                                                                          |
  539. |FLDDATA4      FLDFILE4             FLDDATA5      FLDFILE5                 |
  540. |                                                                          |
  541. |FLDDATA6      FLDFILE6             FLDDATA7      FLDFILE7                 |
  542. |                                                                          |
  543. |FLDDATA8      FLDFILE8             FLDDATA9      FLDFILE9                 |
  544. |                                                                          |
  545. |--------------------------------------------------------------------------|
  546.                                                                           
  547.     And here is the ORDERS data entry screen that the entry above would support. 
  548. Asterisks show where the looked up data will be stuffed by WAMPUM.  
  549. |----------------------------------------------------------------------------|
  550. |Record No.      2                                                           |
  551. |CUSTOMER Mundy, Ward           ADDRESS 4160 Club Drive                      |
  552. |                                                                            |
  553. |CITY Atlanta          STATE GA               ZIP 30319       ORDERDT   /  / |
  554. |                                                                            |
  555. |PARTNO_1 *****       DESCRIP_1  *********  PRICE_1  *********  QUAN_1       |
  556. |                                                                            |
  557. |PARTNO_2             DESCRIP_2             PRICE_2       0.00  QUAN_2       |
  558. |                                                                            |
  559. |PARTNO_3             DESCRIP_3             PRICE_3       0.00  QUAN_3       |
  560. |                                                                            |
  561. |ORDER_TOT        0.00  ORDERNO                                              |
  562. |----------------------------------------------------------------------------|
  563.                                                                             
  564.     In the FILE field of TABLE.DBF, you enter the name of the data base to be
  565. used for the table lookup.  It may include a path if desired.  In the INDEX
  566. field, enter the name of the INDEX file, if desired.  If an index is used, the
  567. file will be sorted in the order of the index when the table is popped up. 
  568. Specifying a PROMPT determines whether the user will be asked to enter search
  569. criteria before the pop-up table appears.  The prompt should correspond to the
  570. INDEX which will be used for the lookup.
  571.  
  572.     The 9 DISPLAY fields permit you to define up to 9 fields from the table
  573. which should be shown when the table pops up.  If all the DISPLAY fields are
  574. left blank, then ALL fields in the table will be displayed and the user can
  575. browse through all of them.  This may or may not be what you desire.
  576.  
  577.     There also are 9 pairs of FLDDATA and FLDFILE fields.  This is where you
  578. tell WAMPUM which fields from the table lookup entry should be stuffed in which
  579. fields displayed on the data entry screen.  You do NOT have to specify any of
  580. these in which case the user could look at a table but could NOT stuff data from
  581.  
  582. the table into the data entry form.  In the alternative, you may specify 1 to 9
  583. pairs of data to be stuffed into the data entry form.
  584.  
  585.     For example, FLDDATA1 above contains an entry of 7 and FLDFILE1 specifies
  586. PARTNO.  This means when the user chooses an entry in the table, WAMPUM will
  587. automatically move the PARTNO of the entry chosen to seventh field on the ORDERS
  588. data entry screen.  Looking at the primary data entry screen tells you that the
  589. seventh field is the first part number ordered field: PARTNO_1.
  590.  
  591.     Two alternatives are available in "stuffing" data.  Specifying a number in
  592. the FLDDATA1 field forces data into a specific field on the ORDERS data entry
  593. screen as was done above.  In some cases, however, you may wish to use one table
  594. to stuff data into a number of different fields on the data entry screen.  If
  595. FLDDATA1 had been left blank (i.e. 0), then WAMPUM will stuff PARTNO into the
  596. field where the cursor was when the pop-up table was activated.  The only
  597. drawback of the latter method is that multiple fields obviously cannot be
  598. stuffed with data simultaneously.  Since we wanted to look up a part name,
  599. number, and price above, the second approach simply would not be appropriate.
  600.  
  601.     Once you have completed the entries in the TABLE.DBF file, SAVE your work by
  602. pressing CTRL-W.  Then <ESC>ape to the Main Menu, and press ALT-0 to reload the
  603. default configuration.  Now try out your handiwork!
  604.  
  605.  
  606. III.  Using 5 Relational Data Bases for Reports & Labels
  607.  
  608.     Prior versions of WAMPUM already supported one additional relational table
  609. for relating during execution of reports and labels.  WAMPUM 4.5 expands this to
  610. five through the W - WAMPUM Preformatted Output option.  If you have existing
  611. WAMPUM applications, these can be modified by changing the structure of your
  612. WAMPUM.DBF files to the following:
  613.  
  614. NUM  FLD NAME      TYPE      FLD LEN     FLD DEC
  615. ---  ----------    ----     ---------    -------
  616.   1  DATAFILE       C            8          0
  617.   2  SORTINDX       C            8          0
  618.   3  RPTLBLFRM      C            1          0
  619.   4  OUTFILE        C            8          0
  620.   5  FONT           N            1          0
  621.   6  CRITERIA       C          213          0
  622.   7  DESCRIP        C           30          0
  623.   8  RELFILE        C            8          0
  624.   9  RELKEY         C            8          0
  625.  10  RELFILE2       C            8          0
  626.  11  RELKEY2        C            8          0
  627.  12  RELFILE3       C            8          0
  628.  13  RELKEY3        C            8          0
  629.  14  RELFILE4       C            8          0
  630.  15  RELKEY4        C            8          0
  631.  16  RELFILE5       C            8          0
  632.  17  RELKEY5        C            8          0
  633.  
  634.     New applications automatically will have a WAMPUM.DBF file created with the
  635. above structure when you choose W - WAMPUM Preformat and tell the system to
  636. create the new file. Existing rules for relating data bases as outlined in the
  637. Second Edition User's Guide apply to the additional relations as well.
  638.  
  639.     A sample application demonstrating the new relational file capabilitity is
  640. stored on your disk in the \WAMPUM\SAMPLE2 directory.  Read its README.DOC file.
  641. IV.  Computational Functions in Related Data Bases
  642.  
  643.     Prior versions of WAMPUM supported CALCULATED FIELDS in the primary data
  644. base through entries in the EDIT.DBF file.  See the Second Edition User's Guide
  645. for more information.
  646.  
  647.     WAMPUM 4.5 greatly expands this functionality by now allowing CALCULATED
  648. FIELDS in not only the primary data base but in any number of related data bases
  649. as well.
  650.  
  651.     The SAMPLE1 application in \WAMPUM\SAMPLE1 gives a good example of where
  652. this would be used.  You are filling orders for PARTS.  As you fill out an order
  653. form for parts, you would like the system to automatically reduce your existing
  654. inventory of the parts ordered by an amount corresponding to the quantity of
  655. parts sold.  Prior to WAMPUM 4.0, this typically required the services of a very
  656. skilled programmer.  Now, you can do it yourself.
  657.  
  658.     Read through the \WAMPUM\SAMPLE1\README.DOC file and then complete a couple
  659. of orders.  Change to the PART file and display several of the PART records, you
  660. will notice that the ONHAND quantities are decremented corresponding to the
  661. amount of parts you ordered.
  662.  
  663.     To set up a computational function in a related data base, you simply add a
  664. record to the EDIT.DBF file (after READING and FOLLOWING the rules outlined in
  665. the User's Guide with respect to record 1).  See the section in the User's Guide
  666. entitled "Using Table-Lookup for Calculated Fields."  It begins on page 64.
  667.  
  668.     The syntax is identical to that shown in the User's Guide on p. 65 with one
  669. enhancement.  For item 2(d), you now may enter either the field number of the
  670. field in the primary data base to be calculated OR you may enter the actual
  671. field name of a field in the related file specified in item 2(b).
  672.  
  673. V.  Using the UNIQUE table to calculate unique entries
  674.  
  675.     There are a number of times when you need to calculate a unique value for a
  676. particular field.  Account numbers, order numbers, part numbers, and the like
  677. all lend themselves to this.  WAMPUM 4.5 now will handle the calculation for
  678. you.  Here are the steps necessary to implement it.
  679.  
  680.     First, create a new database called UNIQUE.  Create a single field with a
  681. field name of UNIQUE, field type Numeric, and a field length of 5-9 digits
  682. depending upon your application.  Add one record to this file with the starting
  683. number.  The entry should be large enough to fill out all field positions with a
  684. number.  For example, if a five digit field is used, start with at least 10000.
  685.  
  686.     Store this file in the directory in which you are building your application
  687. that will rely on the UNIQUE table.  Add an entry to the EDIT.DBF table (with
  688. the caveats outlined above) which looks like the following:
  689.  
  690.     EDITTEST: #HELPCODE=1 .AND. EMPTY(FLDDATA[20])
  691.  
  692.     ERRMSG:   20,UNIQUE
  693.  
  694.     The # sign tells WAMPUM that this calculated field will rely upon the UNIQUE
  695. table.  Following the # sign, specify the logical expression telling WAMPUM when
  696. the calculation should be executed.  In this case, HELPCODE=1 tells WAMPUM to
  697. execute this instruction only when the user is in ADD RECORD mode.  The
  698. remaining condition assures that a table calculation is not performed if there
  699. already is an entry in the field.
  700.     In the ERRMSG field, specify the number of the field to be calculated, then
  701. a comma, and then the expression to calculate the field value.  Looking at the
  702. ORDERS data entry screen several pages back reveals that the ORDERNO field is
  703. field #20.  Since it is a numeric field, the numeric contents of UNIQUE can be
  704. "stuffed" directly into the field.
  705.  
  706.     NOTE:  WAMPUM always increments the UNIQUE value by 1 BEFORE stuffing the
  707. value in the designated field.
  708.  
  709.     An example of the above is also contained in the \WAMPUM\SAMPLE1
  710. application.  Read the README.DOC file in that directory for additional details.
  711.  
  712.  
  713. VI.  "Pop-Up" Phone Dialer
  714.  
  715.     For those with a Hayes-compatible modem, WAMPUM now provides a pop-up phone
  716. dialer from the Main System Menu.  Make sure you connect a telephone to your
  717. modem's telephone output jack.
  718.  
  719.     Copy all of the PHONFILE files (PHONFILE.*) into each directory where you
  720. wish to use the pop-up phone dialer.  Or place these files in your DOS PATH.
  721.  
  722.     Run WAMPUM in Developer Mode by typing WAMPUM VOODOO.  Use F - File Select
  723. and choose the PHONFILE data base.  When the Main Menu reappears, you can use
  724. the A - Add Records option to add new entries to your phone file.  When you
  725. finish adding names and phone numbers, return to the Main Menu and press ALT-0
  726. to reload your default configuration.
  727.  
  728.     Choose the * - CONFIG Update option and enter the number of the COM port to
  729. which your modem is attached.  If you have TOUCH-TONE service and a Hayes-
  730. compatible modem, the MODEM INIT string should be fine.  Specify the time in
  731. seconds that WAMPUM should wait before redialing.  A value of 30 to 45 is
  732. recommended.  Then <PgDn> and SAVE your new configuration to disk.
  733.  
  734.     To use the phone dialer, return to WAMPUM's Main System Menu.  Press ALT-P. 
  735. The dialer menu will pop-up.  Highlight the person you want to call and press
  736. the <ENTER> key.  Or you can exit from the dialer by pressing <ESC>ape.
  737.  
  738.     The dialer should dial the desired number within 3 seconds.  Pick up your
  739. telephone and wait for the called party to answer.  When they answer, press
  740. either the <ESC> key or the space bar to turn OFF redial.
  741.  
  742.     If you get a BUSY signal, press <ENTER> to immediately redial the number.
  743.  
  744. VII.  "Pop-Up" DOS Applications Menu
  745.  
  746.     WAMPUM 4.5 now permits developers to build in as many external DOS
  747. applications to WAMPUM's Main Menu as desired.  Each application may use up to
  748. 512K memory provided you have at least a 640K system.  In short, end-users may
  749. now execute other DOS applications including word processors, communications,
  750. and spreadsheet software without ever leaving WAMPUM's Main Menu.
  751.  
  752.     The only system requirement is that you keep at least 512K of empty disk
  753. space since WAMPUM uses this work space when external applications are run.
  754.  
  755.  
  756.     A sample DOSAPPS.DBF file accompanies the software.  This data base can be
  757. changed to meet your individual needs.  There is no limitation to the number of
  758. applications which can be added to the file.  However, the applications will
  759. pop-up in the same order in which they are entered into the file.
  760.  
  761.     Here is a sample DOSAPPS data entry form.
  762.  
  763. |-------------------------------------------------------------------------|
  764. |Record No.      2                                                        |
  765. |PROGRAM Exit to Small DOS     SUPERVONLY F                               |
  766. |                                                                         |
  767. |COMMAND C:\command                                          TEMPDRIVE    |
  768. |                                                                         |
  769. |MEMORY 128  PAUSE F                                                      |
  770. |-------------------------------------------------------------------------|
  771.                                                                           
  772.     In the PROGRAM field, specify the text which should display for this  
  773. application when the user selects the ! - RUN External Program option.    
  774.                                                                           
  775.     In the SUPERVONLY field, type T or Y if only those running with the   
  776. developer password should have access to this application.  Otherwise, the
  777. application will be available to anyone who has privileges to use the ! option.
  778.                                                                           
  779.     In the COMMAND field, type the actual DOS command to be executed.  This may
  780. include a drive and path name with DOS 3.0 and higher IF the program does not
  781. rely on overlays OR if the program is stored in a DOS PATH directory.  The
  782. command must be the name of a file with an extension of .EXE, .COM, or .BAT. 
  783. Note that .BAT batch files may contain any combination of DOS commands.  If you
  784. use a batch file and change drives or directories, make certain that you change
  785. back to the appropriate drive and directory before exiting back to WAMPUM.
  786.                                                                           
  787.     In the TEMPDRIVE field, specify the drive where WAMPUM must have 512K of
  788. disk space for work space.  If the default drive has this must space, leave this
  789. blank.  If you have a RAMDRIVE with 512K free, this is the ideal drive.   
  790.                                                                           
  791.     In MEMORY, enter the maximum amount of memory which will be needed by this
  792. application.  If the number is too low, the application will NOT load.  If you
  793. leave it blank, WAMPUM will use all available memory up to 512K.  If your 
  794. program needs less memory than 512K, do NOT leave it blank.  Inserting a lower
  795. number will permit WAMPUM to load your application quicker.               
  796.                                                                           
  797.     Marking the PAUSE field True will cause WAMPUM to pause after you exit your
  798. applicaton before returning to the WAMPUM Main System Menu.               
  799.                                                                           
  800.     The sample above shows how one would specify an option allowing the user to
  801. exit to DOS.  The user then can return to WAMPUM by typing EXIT at the DOS
  802. prompt.                                                                   
  803.                                                                           
  804.     Important NOTE:  Since WAMPUM swaps a portion of itself to disk while other
  805. programs are running, there is NO performance degredation in running other DOS
  806. programs from within WAMPUM.  Once these programs are loaded into memory, they
  807. will operate just as if they had been run from the DOS prompt.            
  808.                                                                           
  809. VIII.  The DITTO hot-key                                                  
  810.                                                                           
  811.     By popular demand, we have added a DITTO "hot-key" that will duplicate any
  812. previously entered data for the same field in any other record.  The hot key is
  813. ALT-N and is available in both ADD and EDIT modes of WAMPUM.              
  814.  
  815. IX.  A Few Gotcha's to Watch Out For                                      
  816.                                                                           
  817.     When you create indexes within WAMPUM, the program records which indexes go
  818. with which data bases in a file called filename.mem where filename is the name
  819. of the data base.  Do NOT delete indexes at the DOS level!  Delete them within
  820. the I - Index Select/Create option.  In this way, WAMPUM will update the .MEM
  821. file correctly.  Otherwise, you will get smoke when you attempt to use the data
  822. base again.  If you forget and delete indexes at the DOS level, then simply
  823. delete the FILENAME.MEM file corresponding to the data base file name.  You then
  824. must reselect the indexes which go with this data base the next time you use it.
  825.                                                                           
  826.     The Browse functions have been reworked considerably from version 3.  If you
  827. wish to browse before editing or displaying complete records with E - Edit
  828. Record or D - Display Records, then press ALT-B to TURN ON BROWSE.  If you want
  829. to select fields to browse, mark the option Y, highlight the desired fields and
  830. press <ENTER>.  <ESC> when done.  Until you turn BROWSE OFF by pressing ALT-B
  831. again, you always will get a browse display when using display or edit options.
  832. Setting a BROWSE FIELD LIST in record 1 of EDIT.DBF is no longer supported.
  833.                                                                           
  834.     If you wish to permanently record the BROWSE status as well as the BROWSE
  835. FIELDS LIST, then first perform the steps in the paragraph above.  Now choose
  836. the * - CONFIG Update option.  When the configuration screen appears, press
  837. <PgDn>, then type Y to save the configuration to disk.  The POWER BROWSE  
  838. features described on page 5 of this file use the same FIELD LIST.        
  839.                                                                           
  840.     The hardest thing to learn in dBASE seems to be how to concatenate (join)
  841. two fields for a mailing label.  It is covered in detail in the Second Edition
  842. User's Guide.  It is repeated here for those that don't read that far.  You can
  843. only join character fields in dBASE.  If you wish to join fields which are not
  844. character fields, you must first convert them to character fields using a dBASE
  845. "function."  STR() is the numeric to string function.  It converts a number to a
  846. character field.  DTOC() is the date to character function.  It converts a date
  847. to a character field.  If you have a numeric field named FEE, you can convert it
  848. to a character string with the expression STR(FEE,7,2) where 7 is the TOTAL
  849. number of positions in the character string (including the decimal point, if
  850. any) and 2 is the number of decimals.  If you have a date field named BIRTHDAY,
  851. you can convert it to a character string with the expression DTOC(BIRTHDAY).
  852.                                                                           
  853.     Usually what causes mailing labels to self-destruct is a label format in
  854. which CITY and STATE are character fields and ZIP is a numeric field (a NO-NO!
  855. since some zip codes start with a zero which will NOT be preserved in a numeric
  856. field).  If you insist on leaving ZIP as numeric, then the correct expression to
  857. join these three fields AND trim off trailing spaces from the CITY field is as
  858. follows: TRIM(CITY)+", "+STATE+" "+STR(ZIP,5).  If the three fields were ALL
  859. character fields, the expression is TRIM(CITY)+", "+STATE+" "+ZIP.  The periods
  860. which end the two sentences above are NOT part of the expressions!  Whew! 
  861.                                                                           
  862.     Do NOT delete the MENU #'s list in the * - CONFIG Update option.  These are
  863. the item numbers on the Main System Menu.  For each number you delete, the
  864. corresponding option on the Main System Menu will NOT work!               
  865.                                                                           
  866.     The HEADING above the Main Menu can be changed easily by choosing * - CONFIG
  867. Update. It does NOT necessarily reflect the current WAMPUM version!  Read the
  868. logo after exiting to DOS to determine your current WAMPUM version.       
  869.                                                                           
  870.     The Clipper and dB-3 compatible index versions of WAMPUM do NOT support
  871. changing a field type in an existing file UNLESS you also change the field name. 
  872. Changing the field name will NOT preserve existing data!  You have several
  873. options if you want to preserve your data AND change the field type of an 
  874. existing field in the data base.  First, if you have not yet entered data into
  875. the file, then just create a new data base from scratch.  Second, you may add a
  876. field to the existing data base with a new field name and the correct field
  877. type.  Leave the old one for the time being.  Once the file structure has been
  878. modified, then use the GLOBAL SEARCH and REPLACE option to "move" the old data
  879. into the new field.  Step 1 - Choose S - Select Utilities and enter a selection
  880. criteria of RECNO()>=1 which means ALL RECORDS.  Step 2 - Choose G - Global
  881. Search and Replace option.  Use the <Dn> arrow to choose the NEW field.  Press
  882. <ENTER>.  Type the expression necessary to copy the data from the old field. 
  883. REMEMBER: You MUST use a CONVERSION FUNCTION described above to convert the old
  884. data into the new TYPE data!  Once this finishes, look through your records to
  885. make sure you got what you wanted.  When you are satisfied, change the structure
  886. of your data base again by selecting B - Build New File then entering *.  Now
  887. delete the field you no longer need.    
  888.     Finally, if you get errors every time you attempt to start up WAMPUM,
  889. chances are there is something wrong with your default data base.  You can get
  890. into WAMPUM easily if you first delete the WAMPUM.MEM file in the default data
  891. base.  Deleting this file means you are deleting your default configuration!
  892.   
  893. X.  Loading WAMPUM as a TSR 
  894.  
  895.     As with many features in WAMPUM, we endeavor to provide the latest and
  896. greatest bells and whistles in the industry. One such feature is the ability to
  897. load even very large programs (such as WAMPUM) as miniscule terminate-and-stay-
  898. resident programs (TSR's).  For those unfamiliar with TSR technology, it gives
  899. the user the ability to load a program into resident memory and then hide it
  900. from view while working with one or more other programs.  One past limitation of
  901. TSR's was their appetite for resident memory, often considerably more than 100K. 
  902. This made TSR's less and less desirable as newer programs required more and more
  903. RAM to execute.  With WAMPUM 4.5, you now can have your cake and eat it, too. 
  904. Once loaded as a TSR in background, WAMPUM consumes less than 20K!  It does this
  905. by saving most of the contents of its memory temporarily to someplace other than
  906. main memory.  It first looks to see if you have expanded memory, then extended
  907. memory, and finally to your default disk drive.  Between the three places, you
  908. MUST have at least 512K of space available.  Stated another way, if you have NO
  909. expanded or extended memory, you must have at least a half megabyte of free hard
  910. disk space on your default drive BEFORE loading WAMPUM as a TSR.
  911.  
  912.     WAMPUM 4.5 may be loaded as a TSR by including the word TSR on the command
  913. line when WAMPUM is started.  For example, WAMPUM TSR would load WAMPUM as a TSR
  914. while WAMPUM TSRDISK would load it as a TSR and force RAM contents to disk. This
  915. may be necessary with non-standard EMS or extended memory. If loaded from a
  916. batch file, make sure WAMPUM is the last command in the file!  Additional batch
  917. commands can be executed in a batch file (TSR.BAT) after loading WAMPUM as TSR. 
  918.  
  919.     Once WAMPUM is loaded as a TSR as described above, it can be popped up from
  920. within any other TEXT-BASED foreground application by pressing <ALT-W>.  From
  921. WAMPUM's Main Menu only, you then can put it back to sleep in the background by
  922. pressing <ALT-W>.  NOTE:  The reason for the limitation to WAMPUM's Main Menu is
  923. for YOUR protection. On this menu, all WAMPUM files are always CLOSED and SAFE!
  924.  
  925.     WAMPUM's speed in loading and unloading as a TSR is dependent upon several
  926. factors: the speed of your processor, the amount of extended and expanded memory
  927. you have, and (if you have less than 512K of free expanded or extended memory)
  928. the speed of your hard disk.  If you have a clunker XT with 640K and a hard disk
  929. which operates at the speed of a floppy, then WAMPUM's usefulness as a TSR will
  930. NOT be a pleasant experience.  On the other hand, if you have 512K of EMS memory
  931. free or a 30 millisecond hard disk, WAMPUM will pop up and down as a TSR almost
  932. instantaneously (with EMS memory) or VERY quickly (with fast hard disk). 
  933. XI. Adding .PCX Images to Your WAMPUM Applications  (Version 4.5 enhancement)
  934.  
  935.     One of the major deficiencies in the data base market has been the inability
  936. to blend pictures and images into data bases.  For example, real estate appli-
  937. cations are much more meaningful if a picture of the property or its floor plan
  938. accompanies the other traditional data base information. In the insurance field
  939. the ability to capture a photo of a piece of property as part of the data base
  940. record would be invaluable.  In ID systems, adding photos and/or pictures of a
  941. signature or fingerprint provides a whole new dimension in the data base. And
  942. last but not least, collectors of all persuasions have asked for years for the
  943. ability to capture a picture of the collected item in their data bases whether
  944. they collect artwork, stamps, beer cans, baseball cards, race horses, or wives.
  945.  
  946.                  LINKING .PCX IMAGES TO YOUR dBASE DATA BASES
  947.  
  948.     Well, the wait is over!  WAMPUM now allows you to link images in the 
  949. industry-standard .PCX format to your dBASE-compatible data bases.  The steps
  950. to do this are outlined below.
  951.  
  952.     1.   Either create a new data base or use an existing dBASE data base.
  953.  
  954.     2.   Identify a CHARACTER-type field which will be used to store
  955.          the file names of the .PCX files. You can have more than one!
  956.  
  957.     3.   As you add records to your data base, type the name of the
  958.          .PCX file in this field.  For example, if you had a character
  959.          field named MLSNUM in which you stored the multiple listing
  960.          service number of a particular piece of real estate, then all
  961.          that is required to link a .PCX image of the same piece of
  962.          real estate to this record is to name the .PCX file the same
  963.          as the MLSNUM which was typed in this record.
  964.  
  965.     4.   WAMPUM assumes the image file's extension is .PCX unless you
  966.          specifically include a file extension.  Thus, if the MLSNUM
  967.          were 12345, the image file should be named 12345.PCX
  968.  
  969.                  DISPLAYING .PCX IMAGES WITHIN YOUR DATA BASES
  970.  
  971.     To display the .PCX files, you MUST have a graphics monitor which supports
  972. either VGA, EGA, or Hercules graphics.  If you have an older EGA card which
  973. requires software activation of Hercules-compatible graphics with a monochrome
  974. display, make sure you do this before running WAMPUM.
  975.  
  976.     1.   .PCX images can be displayed in ADD, EDIT or BROWSE modes from
  977.          WAMPUM's Main Menu.  If you choose to EDIT an existing record,
  978.          then enter a key to display the desired record.
  979.  
  980.     2.   Move the cursor to the field you are using to identify your
  981.          .PCX images.  E.g. move to MLSNUM in the example above.
  982.  
  983.     3.   Press <ALT-V> to view the .PCX image on your graphics monitor.
  984.          If WAMPUM beeps at you, then one of several things has
  985.          happened: either you don't have a graphics card installed or
  986.          enabled, or the field is not a CHARACTER-type field, or there
  987.          is no .PCX file with a name matching the data contained in the
  988.          current field.  
  989.          Usually the problem will be a missing .PCX file in your
  990.          current directory or DOS PATH.  If the field value says 12345,
  991.          then you must have a file named 12345.PCX in your directory.
  992.                    PRINTING .PCX IMAGES FROM YOUR DATA BASES
  993.  
  994.     While the image is displayed on your screen, you may print it provided you
  995. have (1) a graphics printer and (2) if you have previously loaded a graphics
  996. print screen driver which supports your printer BEFORE running WAMPUM.
  997.  
  998.     DOS includes a GRAPHICS.COM program which will allow you to print graphics
  999. images using an IBM or Epson-compatible dot matrix printer.  To load the driver
  1000. type GRAPHICS at the DOS prompt before running WAMPUM.
  1001.  
  1002.     If you have an HP LaserJet, there are several public domain or shareware
  1003. graphics printer drivers available in the marketplace.  Load one of these into
  1004. memory before running WAMPUM.  For other types of printers, you'll need to shop
  1005. around to find a graphics screen print utility that supports your printer.
  1006.  
  1007.     Once the graphics print driver has been loaded, simply follow the steps
  1008. above to display the graphics image within WAMPUM.  Then press <SHFT-PRTSCRN> 
  1009. to print the .PCX display  on your printer.
  1010.  
  1011.  
  1012.                        .PCX IMAGE FILES -- SPECIAL NOTES
  1013.  
  1014.     There are a few things to watch out for when using WAMPUM's graphics image
  1015. support.
  1016.  
  1017.     First, you must appreciate that there are thousands of different graphics
  1018. cards and monitors.  Most do what the salesman told you they would. A few 
  1019. don't.  If it doesn't work, it simply doesn't work.  We have tested WAMPUM
  1020. with Hercules, EGA, and VGA cards from the major manufacturers.  ALL of them
  1021. work!  We'd like to know about any incompatibilities, but we can't guarantee
  1022. we'll be able to make WAMPUM work with every quirky card and monitor around.
  1023.  
  1024.     Second, if you have a monochrome monitor and an EGA card, you should be
  1025. aware that the EGA card was designed to emulate BOTH the IBM monochrome
  1026. display card (which does NOT support graphics) and the Hercules graphics
  1027. card (which DOES support graphics).  You MUST configure the card to support
  1028. the latter.  This may require use of a software setting to enable Hercules
  1029. graphics mode. WAMPUM cannot distinguish between the two modes, and this may
  1030. cause your system to hang if the EGA card is set to non-graphics mode.
  1031.  
  1032.     Finally, for those new to graphics, you're probably wondering how to con-
  1033. vert your photograph into a .PCX file. The cheapest way is with a hand-scanner.
  1034. For about $150, you will get fairly good resolution black and white .PCX files.
  1035. At the other end of the spectrum, the sky is the limit in terms of cost.  The
  1036. most popular image capture card is the TARGA 16 with a retail price of $1995.
  1037. With this card, you can capture images directly from a video camera which can
  1038. output either an NTSC composite video signal (like a VCR) or an RGB analog one.
  1039. If black and white scans won't do, a color scanner such as Howtek's Scanmaster
  1040. can be had for $6,195.  It works well with the Targa 16 from Truevision.  You
  1041. then will need a program called T-EGA ($199) from Videotex Systems to convert
  1042. TARGA files to .PCX format.  Their number is 800/888-4336.
  1043.  
  1044.     The CHEAPEST OPTION for color projects is probably to have someone convert
  1045. pictures to .PCX files for you.  One such vendor is Graphic Edge. Their number
  1046. is 214/638-8416.  They charge about 15 bucks a picture for color.  ENJOY!!!
  1047.  
  1048.  
  1049.                  CUSTOMIZING THE GRAPHICS DISPLAY ENVIRONMENT
  1050.  
  1051.     WAMPUM deciphers most graphics cards correctly.  If you would prefer a dif-
  1052. ferent resolution or number of colors, you may override the settings which nor-
  1053. mally would be chosen by adding the following command to your AUTOEXEC.BAT file
  1054. or simply typing it at the DOS prompt before running WAMPUM: SET VM=mode where
  1055. mode is a number from the following table.  Default modes show an asterisk.
  1056.  
  1057. MODE        RESOLUTION  COLORS  HARDWARE REQ'D
  1058. ----        ----------  ------  --------------
  1059.  4          320 x 200      4    CGA/EGA/VGA
  1060.  6          640 x 200      2    CGA*/EGA/VGA
  1061. 13          320 x 200     16    EGA/VGA
  1062. 14          640 x 200     16    EGA/VGA
  1063. 15          640 x 350      2    EGA/VGA
  1064. 16          640 x 350     16    EGA*/VGA
  1065. 17          640 x 480      2    VGA
  1066. 18          640 x 480     16    VGA*
  1067. 19          320 x 200    256    VGA
  1068. 40          640 x 400    256    Super VGA
  1069. 41          640 x 480    256    Super VGA
  1070. 42          800 x 600    256    Super VGA
  1071. 43         1024 x 768    256    Super VGA
  1072. 99            -->        -->    (mode is set by value stored in the .PCX file)
  1073. 200         720 x 348      2    Hercules*
  1074.  
  1075.     If you are capturing your own .PCX files and wish to use different reso-
  1076. lutions and numbers of colors for different images, then you should issue the
  1077. command SET VM=99.  In this case, WAMPUM will read the mode setting embedded
  1078. in the .PCX file and set the display adaptor accordingly.
  1079.  
  1080.     Our best advice is to first experiment with no setting of the VM variable.
  1081. If the results are unsatisfactory, then you may wish to manually try several
  1082. different video mode settings until you find one that meets your needs.
  1083.  
  1084.     DO NOT UNDER ANY CIRCUMSTANCES SET A VIDEO MODE OTHER THAN ONE OF THE
  1085.     NUMBERS SHOWN ABOVE.  DOING SO WILL ALMOST CERTAINLY SEND WAMPUM INTO
  1086.     THE OZONE THE FIRST TIME YOU ATTEMPT TO DISPLAY A .PCX IMAGE.
  1087.  
  1088.  
  1089.             WARD MUNDY SOFTWARE, P.O. Box 1169, ATLANTA, GA 30301
  1090. Ph:404/237-9420 AT&T:10288-0-700-WARD-MUNDY Fax:404/237-1167 BBS:706/746-5109
  1091.  
  1092.                     C U S T O M E R    I N V O I C E
  1093.  
  1094.  
  1095.  
  1096.      +---------------------------------------------------------------+
  1097.      |Customer:                          |Order Date:                |
  1098.      |                                   |---------------------------|
  1099.      |                                   |Shipped Dt:                |
  1100.      |                                   |---------------------------|
  1101.      |                                   |Invoice No:                |
  1102.      |                                   |---------------------------|
  1103.      |                                   |P.O. Number                |
  1104.      +---------------------------------------------------------------+
  1105.                                                                      
  1106.      +---------------------------------------------------------------+
  1107.      |QUANTITY |DESCRIPTION                   |UNIT PRICE|  AMOUNT   | 
  1108.      |---------|------------------------------|----------|-----------|
  1109.      |         |                              |          |           |
  1110.      |         |WAMPUM Second Ed. Users Guide |  20.00   |           |
  1111.      |         |                              |          |           |
  1112.      |         |WAMPUM 4.5 Single User License|  50.00*  |           |
  1113.      |         |                              |          |           |
  1114.      |         |WAMPUM 4.5 Network License    | 195.00*  |           |
  1115.      |         |                              |          |           |
  1116.      |         |WAMPUM Remote 4.5 Single User |  50.00*  |           |
  1117.      |         |                              |          |           |
  1118.      |         |WAMPUM Remote 4.5 Network     | 195.00*  |           |
  1119.      |         |                              |          |           |
  1120.      |         |WAMPUM Site License (1993)    | 995.00*  |           |
  1121.      |         |                              |          |           |
  1122.      |         |WAMPUM Site License (later)   |1500.00   |           |
  1123.      |         |                              |          |           |
  1124.      |         |MenuMaker for WAMPUM/dLITE    |  20.00   |           |
  1125.      |         |                              |          |           |
  1126.      |         |dLITE 30-day ShareWare Lic.   |   5.00   |           |
  1127.      |         |                              |          |           |
  1128.      |         |dLITE Single User License     |  25.00   |           |
  1129.      |         |                              |          |           |
  1130.      |         |Badge-O-Magic 30-day ShareWare|   5.00   |           |
  1131.      |         |                              |          |           |
  1132.      |         |Badge-O-Magic License per PC  |  45.00*  |           |
  1133.      |         |                              |          |           |
  1134.      |         |Badge-O-Magic Deluxe          |  95.00*  |           |
  1135.      |         |                              |          |           |
  1136.      |---------------------------------------------------------------|
  1137.      |* Specify INDEX: Clipper( )  dBASE III+(  )   3-1/2" disk?(  ) |
  1138.      |---------------------------------------------------------------|
  1139.      |         | Foreign Shipping Surcharge   |   5.00   |           |
  1140.      |         |                              |          |           |
  1141.      | Order   | Shipping & Handling Charges  |   5.00   |    5.00   |
  1142.      |         |                              |----------|-----------|
  1143.      |         |                              |  TOTAL   |           |
  1144.      +---------------------- Thank You! -----------------------------+
  1145.      NOTE: We provide 50% software discounts to all accredited schools.                                                                 
  1146.      TERMS: Please make check payable to Ward Mundy, P.O. Box 1169, 
  1147.      Atlanta, GA 30301.  Checks drawn on U.S. banks only! Or you may
  1148.      send VISA/MasterCard card number, expiration date and signature.
  1149.  
  1150.